Contexto global

DoQueryBox

Sintaxis:

DoQueryBox(<TextoConsulta>, <Botones>, <TiempoEspera>, <BotonPredeterminado>, <Titulo>, <BotonTiempoEspera>)

Parámetros:

Tipo: Cadena, CadenaFormateada.
Texto de la consulta que se envía.

Tipo: QuestionDialogMode, ValueList.
Define el contenido y el texto de los botones del diálogo, y los valores vinculados a los botones.
Cuando se utiliza el tipo ValueList:

• Value – contiene el valor vinculado al botón. Este valor se devuelve cuando se selecciona el botón. Se pueden utilizar valores de DialogReturnCode y otros valores de la enumeración como valor;
• Presentation – especifica el texto del botón. Si no se especifica la presentación y se utilizan valores de la enumeración DialogReturnCode, se utiliza la presentación estándar;
• Picture – no se utiliza (debe estar vacío);
• Check – no se utiliza (debe estar vacío).

Cuando se utiliza el tipo ValueList, la lista no debe estar vacía.

Tipo: Número.
Período en segundos que el sistema esperará una respuesta. Cuando este período expire, se cerrará la caja de consulta. Si no se indica el parámetro, entonces el tiempo de inactividad es ilimitado.
Si el parámetro tiene un valor negativo, se generará una excepción.
Valor predeterminado: 0.

Tipo: Arbitrario.
Define un botón por defecto por un tipo de botón o por el valor vinculado a él.

Tipo: Cadena.
Contiene el título de la ventana de la pregunta.
Si no se establece, no se mostrará el título del cuadro de diálogo.

Tipo: Arbitrario.
Define el botón (por el tipo de botón o por el valor vinculado a él) en el que se muestra el número de segundos restantes hasta que expire el tiempo de espera.

Valor devuelto:

Tipo: Arbitrario.
Dependiendo de la reacción del usuario, se devuelve el valor de la enumeración del sistema, conectado con el botón presionado.
Si el diálogo se cierra debido al tiempo de espera, se devuelve el valor Timeout.

Descripción:

Abre una caja de consulta.

Disponibilidad:

Cliente ligero, cliente móvil, cliente grueso, aplicación móvil (cliente).

Nota:

En el cliente web, si no se utiliza el botón Esc (no hay botón relacionado con el valor Cancel) y el usuario cierra la ventana usando el botón “Cerrar”, se abrirá nuevamente el diálogo con los parámetros iniciales.
Si la configuración tiene la propiedad ModalityUseMode establecida en DontUse, utilice el método ShowQueryBox en su lugar.

Ejemplo:

Consulte también:

Contexto global, método DoQueryBoxAsync
Contexto global, método ShowQueryBox

Disponible desde:

Disponible desde la versión 8.0.

Descripción cambiada en la versión 8.3.18.